home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio / Ham Radio CD-ROM (Emerald Software) (1995).ISO / satel / dove / whats-up.doc < prev    next >
Text File  |  1990-02-20  |  19KB  |  550 lines
  1.         WHATS-UP.DOC Page 1.
  2.  
  3.  
  4.  
  5.                       WHATS-UP (c) Joe Kasser, G3ZCZ, 1990
  6.  
  7.                                    Member ASP
  8.  
  9.                               Joe Kasser G3ZCZ/W3
  10.                                11241 Fairoak Drive
  11.                               Silver Spring, Md. 20902
  12.                                  (301) 593 6136
  13.  
  14.                                   G3ZCZ @ N4QQ
  15.  
  16.         This is an interim documentation file.  A fuller document will be 
  17.         published with release 1.00.
  18.  
  19.         This version of WHATS-UP is a concept demonstration version of  a 
  20.         Telemetry   Decoding  and  display  Program  for   the   MicroSat 
  21.         Spacecraft  (OSCARs 16, 17, 18 and 19).  It is table  driven  via 
  22.         the configuration files to allow maximum flexibility.
  23.  
  24.         It contains the following features:
  25.  
  26.         *    Real time and Playback modes.
  27.  
  28.         *    Automatic Capture-to-disk of raw telemetry.
  29.  
  30.         *    Link quality measurement.
  31.  
  32.         *    Capability to print the raw telemetry as it is received.
  33.  
  34.         *    Up to 16 user configurable display pages (screens).  You set      
  35.              the  position on the page (width of engineering unit  field,      
  36.              and number of decimal places) that a parameter is  displayed      
  37.              at.
  38.  
  39.         *    Wild card page (parameter shows up on all pages).
  40.  
  41.         *    Selectable display of Engineering units or Hex byte for each      
  42.              display page.
  43.  
  44.         *    Display of raw packets (i.e. STATUS)
  45.  
  46.         *    Color  changes if a parameter value changed between  succes     
  47.              sive frames.
  48.  
  49.         *    Audio and visual alarms if a parameter value exceeds,  falls      
  50.              below or falls outside a preset limit value(s).
  51.  
  52.         *    Dumb split screen terminal mode (a la LAN-LINK).
  53.  
  54.         *    Customizable  colors, PC to TNC baud rate, data  parity  and      
  55.              stop bits.
  56.  
  57.         *    Default spacecraft configuration files.
  58.  
  59.  
  60.  
  61.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  62.         WHATS-UP.DOC Page 2.
  63.  
  64.  
  65.         *    Time of day clock display (in HH:MM:SS format)
  66.  
  67.  
  68.         WHATS-UP  has three basic modes of operation; Interactive,  real-
  69.         time and playback.
  70.  
  71.         The  Interactive mode is a dumb terminal. You can use it to  give 
  72.         commands  to the TNC. The usual one is to set the TNC  date  from 
  73.         the  computer's  clock.   You  should also  use  it  to  set  the 
  74.         'HEADERLINE  ON'.  In this mode, you will see the raw packets  on 
  75.         the channel.  You can also use this mode as a regular TNC program 
  76.         (If you do, you ought to get your head examined, because LAN-LINK 
  77.         will  do the job much better).  The Real-time mode  converts  and 
  78.         displays engineering data.  You can display up to 16  (configured 
  79.         by  you) pages of information.  Information that changes  between 
  80.         successive  frames, is shown in a different  color.   Information 
  81.         that  has exceeded a preset (by you) limit is shown in  an  alarm 
  82.         color (default: blinking red).  The capture-to-disk will turn  on 
  83.         when  the first packet is copied, and will turn off  two  minutes 
  84.         after the last.
  85.  
  86.         The Playback mode allows you to play back captured telemetry with 
  87.         4 speeds (speedy, slow, slower and snail's pace).
  88.  
  89.         Starting the program.
  90.  
  91.         You may start the program by typing in three ways as follows.
  92.  
  93.         Default
  94.  
  95.         Type  'whats-up'  and return (without the 's).  This  brings  the 
  96.         program  up in the default mode. It will read  the  whats-up.sys 
  97.         file to determine the spacecraft being monitored, and then prompt 
  98.         you for the mode.
  99.  
  100.         User Chosen spacecraft
  101.  
  102.         Type  'whats-up  spacecraft' and return (without  the  's).   The 
  103.         program reads the spacecraft.sys file to load the parameters for 
  104.         the MicroSat of choice, and then prompts you for the mode.
  105.  
  106.         Examples of the command are :
  107.  
  108.         'WHATS-UP DOVE' or 'WHATS-UP PACSAT'
  109.  
  110.         Custom Mode
  111.  
  112.         Type  'whats-up  spacecraft mode' and return  (without  the  's).  
  113.         This  brings the program up in the custom mode. It will read  the 
  114.         whats-up.sys  file to determine the spacecraft  being  monitored, 
  115.         and then start up in the mode you set.  Valid modes are 'p',  'i' 
  116.         and 'r'.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  123.         WHATS-UP.DOC Page 3.
  124.  
  125.  
  126.         Examples of the command are :
  127.  
  128.         'WHATS-UP DOVE R' or 'WHATS-UP PACSAT R'
  129.  
  130.         If you place a command line like this in your autoexec.bat  file, 
  131.         should  you  be copying telemetry in an unattended manner  and  a 
  132.         power  failure take place, the system will boot up into the  cor-
  133.         rect WHATS-UP mode when power is restored.
  134.  
  135.         Contents of the SPACECRAFT.SYS file
  136.  
  137.         In the telemetry processing part, only the quadratic equation  is 
  138.         hard  coded, the coefficients are table driven from a  configura-
  139.         tion file. In fact the contents of the configuration file are  as 
  140.         follows:-
  141.  
  142.         Spacecraft ID.
  143.         Selected or default display page number
  144.  
  145.         Number of display pages (maximum = 16)
  146.  
  147.         Then follows the page definitions, as in for example;
  148.  
  149.         4
  150.         SPACECRAFT HOUSEKEEPING, 30,31
  151.         PAYLOAD, 30, 31
  152.         BATTERY STATUS, 30, 30
  153.         MISC,30,2
  154.  
  155.         the number above the page definitions must be set correctly.
  156.  
  157.         For each page:
  158.  
  159.                   Page title
  160.                   Page color
  161.  
  162.         The  next set of items is the Telemetry parameter  configurations 
  163.         (maximum = 64). You must have at least one of these lines in  the 
  164.         file.   If  you  want a value to show in in more  than  one  page 
  165.         (other than the wild card [0]) you must enter it twice (once  per 
  166.         page). Typically each row looks as follows:-
  167.  
  168.         00,Rx E/F Audio(W):,+0.000,+0.0246,0.000,V(p-p),2,11,1,6,1,0,0,0
  169.         01,Rx E/F Audio(N):,+0.000,+0.0246,0.000,V(p-p),2,11,32,6,1,0,0,0
  170.  
  171.         For each telemetry parameter:
  172.  
  173.              hexadecimal channel number (2 bytes, e.g. '0F' )
  174.              Description text string (e.g. '+Z Array Temp.')
  175.              Equation Coefficient C
  176.              Equation Coefficient B
  177.              Equation Coefficient A
  178.              Units text string (e.g. '.C')
  179.  
  180.              Display page number
  181.  
  182.  
  183.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  184.         WHATS-UP.DOC Page 4.
  185.  
  186.  
  187.              Display page row
  188.              Display page column
  189.              Display width for Engineering Units
  190.              Number of digits after the decimal point
  191.              Limit check flag (0 = do nothing, 1 = check below low limit, 
  192.                                    2= check above high limit, 3 = check 
  193.                                    for  [below low limit] or [above high 
  194.                                    limit])
  195.              Low limit value (e.g. -4.00)
  196.              High limit value (e.g. +10.6)
  197.  
  198.         A  line  with  an  '*' as the  first  character  terminates  that 
  199.         section.
  200.  
  201.         Packet types:-
  202.  
  203.              packet types are set as follows:-
  204.  
  205.              name of UNP address (e.g. WASH, BCXRT)
  206.              Display page for the contents of the packet
  207.              Display color 
  208.              Display row
  209.              Display column
  210.              Display page for the cumulative count of the packet type
  211.              Display row
  212.              Display column
  213.  
  214.         Typical entries are as follows:
  215.  
  216.         WASH, 0, 30,4, 1, 0, 5, 1
  217.         TIME, 0, 31, 1, 1, 0, 5, 12
  218.         STATUS, 0, 29, 2, 1, 0, 5, 24
  219.         BCRXMT, 0, 28, 3, 1, 0, 5, 37
  220.         TLM, 99, 31, 3, 1, 0, 5, 50
  221.  
  222.         These also terminate with an '*' character.
  223.  
  224.  
  225.         Limits are only checked for parameters being displayed (in  Engi-
  226.         neering  units).   With this approach, you can set  up  different 
  227.         pages  for  different on-board subsystems, you can  also  set  up 
  228.         different  display  pages of the same  parameters  for  daylight, 
  229.         darkness  and  terminator crossing passes, with  different  limit 
  230.         values to draw your attention to changes.
  231.  
  232.         The  link quality part allows the following to be done.  You  can 
  233.         define  which  of the packets you want to display/count  (If  you 
  234.         just want to count them and not display them, set the page  value 
  235.         to  99).   You can then view an incrementing count  counter  each 
  236.         time  a  selected packet is received. You can  also  display  the 
  237.         contents  of  the STATUS, WASH or BCXRT packets  in  any  display 
  238.         page.
  239.  
  240.         My  version (the default) is set up to display those  packets  as 
  241.         wild  cards  (i.e will show up on all pages),  and  then  display 
  242.  
  243.  
  244.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  245.         WHATS-UP.DOC Page 5.
  246.  
  247.  
  248.         several temperatures and solar cell array currents.
  249.  
  250.         Program Requirements
  251.  
  252.         Hardware
  253.  
  254.         IBM PC or clone with 256k memory.
  255.         TNC of some kind, I've tested it with a TNC2, a KAM and a  PK-232 
  256.         so far.
  257.  
  258.         Data Format
  259.  
  260.         The  program  DOES require that the telemetry  be  received,  and 
  261.         captured-to-disk  with the packet header on a different  line  to 
  262.         the  contents of the packet (HEADERLINE ON). I also suggest  that 
  263.         you  turn  the date/time stamp on so that when you  get  Revision 
  264.         1.00, you will be able to playback your data and extract selected 
  265.         values and their corresponding time codes into a file that can be 
  266.         read into your spreadsheet program for further trend analysis.
  267.  
  268.         A typical display is shown below.
  269.  
  270.                                SPACECRAFT HOUSEKEEPING
  271.         PHT: uptime is 046/12:38:33.  Time is Tue Jan 30 03:07:27 1990                
  272.          80 00 00 89 B0 18 DD 02 00 B0 00 00 B0 00 00 00 00 00 00 00                  
  273.         vbat= 10.864 vlo1= 10.540 vlo2= 10.040 vmax= 11.540 temp=  6.661              
  274.         wash addr:2a80:0000, edac=0x70                                                
  275.         WASH    28 TIME    22  STATUS    21 BCRXMT     2 TLM    17                    
  276.         +Z Array Cur   :-0.011 A +Z Array Temp  :  -6.7 C  +Z Array V     :   0.1 V   
  277.         -Z Array Cur   :-0.017 A +Y Array Temp  :  10.9 C                             
  278.         -Y Array Cur   :-0.012 A Baseplt Temp   :   6.7 C  BCR Load Cur   : 0.164 A   
  279.         +X Array Cur   :-0.013 A Array V        :   9.8 V                             
  280.         -X Array Cur   :-0.011 A +5 Volt Bus    :   4.9 V  +8.5V Bus      :   8.5 V   
  281.                                  +10V Bus       :  10.8 V  8.5V BUS       :   8.4 V   
  282.         TX#1 RF OUT    :   0.0 W +8.5V Bus Cur  : 0.053 A                             
  283.         TX#2 RF OUT    :   3.7 W +5V Bus Cur    : 0.208 A  BCR Input Cur  : 0.191 A   
  284.                                                            BCR Output Cur :-0.017 A   
  285.         Bat 1 Temp     :   6.7 C Bat 2 Temp     : -20.6 C                             
  286.                                                                                       
  287.         IR Detector    :     0 Counts                                                 
  288.         BCR Set Point  :   134 Counts                                                 
  289.                                                                                       
  290.         WHATS-UP.SYS file format
  291.  
  292.         The contents of the WHATS-UP.SYS file are as follows:
  293.  
  294.         Your callsign           (e.g. G3ZCZ)
  295.         Default configuration file) (e.g. Dove)
  296.         station latitude        (e.g. 35.00)
  297.         station longitude       (e.g. 74.00)
  298.         station all.            (e.g. 100)
  299.         capture-to-disk file    (e.g. dove.RUN)
  300.         playback file           (e.g. dove.run)
  301.         PC serial port          (e.g. 1)
  302.         PC serial baud rate     (e.g. 9600)
  303.  
  304.  
  305.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  306.         WHATS-UP.DOC Page 6.
  307.  
  308.  
  309.         data bits               (e.g. 8)
  310.         Stop bits               (e.g. 1)
  311.         parity                  (e.g. 0)
  312.         status (top) window color (e.g. 79)
  313.         Telemetry Page color    (e.g. 14)
  314.         outgoing window color   (e.g. 14)
  315.         incoming window color   (e.g. 30)
  316.         prompt window color     (e.g. 15)
  317.         alarm window color      (e.g. 15)
  318.         bottom window color     (e.g. 79)
  319.         Emphasis color          (e.g. 14)
  320.         prompt color            (e.g. 14)
  321.         option color            (e.g. 78)
  322.         parameter changed color (e.g. 95)
  323.         parameter limit exceeded color  (e.g. 14)
  324.  
  325.         The callsign and geographic parameters are not used in this  ver-
  326.         sion.
  327.  
  328.         Some typical color combinations are
  329.  
  330.  
  331.         Function Keys
  332.  
  333.         The following function keys are active:
  334.  
  335.         FK 1 capture to disk
  336.         FK 2 type of display Engineering Units/Hex Byte
  337.         FK 3 select display page
  338.  
  339.         Alt-B send a 'break' to the TNC, interactive mode only.
  340.         Alt-P Printer on/off
  341.         Alt-S Sound on/off
  342.         Alt-X Quit
  343.         left arrow decreases playback speed
  344.         right arrow increases playback speed.
  345.  
  346.  
  347.         This  version  as I mentioned above is  a  concept  demonstration 
  348.         version,  and  contains a few cosmetic display bugs.    I  expect 
  349.         (but don't promise) to put out Revision 1.00 with more  features, 
  350.         (such as extraction capability to interface the extracted data to 
  351.         a spreadsheet program for further analysis) and proper documenta-
  352.         tion, sometime between March and June 1990.  This program is  not 
  353.         in  the  public domain but may be copied and passed on.   If  you 
  354.         would  like  a copy of Revision 1.00 which will  be  released  as 
  355.         shareware, send a FORMATTED disk and sase to
  356.  
  357.         Joe  Kasser  G3ZCZ/W3, 11241 Fairoak Drive,  Silver  Spring,  Md. 
  358.         20902.
  359.  
  360.         Better yet, why not register your copy and support development of 
  361.         this  kind of software.  Registered users will receive  all  ver-
  362.         sions 1.00 to 2.00 automatically.
  363.  
  364.  
  365.  
  366.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  367.         WHATS-UP.DOC Page 7.
  368.  
  369.  
  370.         If you have captured any telemetry to disk, especially daytime or 
  371.         southern  hemisphere passes, please put them on the disk.   Don't 
  372.         let  the  data files become too long. I suggest that  you  rename 
  373.         them  every  couple of days or so, such as  DOVE2-16.RUN,  DOVE2-
  374.         18.RUN, etc.
  375.  
  376.         Suggestions for improvements and additions are always welcome.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  428.         WHATS-UP.DOC Page 8.
  429.  
  430.  
  431.         Other Amateur Radio Software by Joe Kasser G3ZCZ
  432.  
  433.         PC-HAM 3.3 BY G3ZCZ
  434.  
  435.         LOGBOOK
  436.  
  437.         Full  blown  logging package.  With automatic check of  logs  for 
  438.         awards such as DXCC.  Allows you to recall any entry by call sign 
  439.         within  seconds. Indexed displays, QSL'ing, Contest  mode  QSLing 
  440.         (prints  the lot) and lots more written in dBASE3, but a compiled
  441.         LOGBOOK.EXE  file is  supplied  together  with  the  source code.  
  442.         Export your  LAN-LINK.LOG file and put this package to work.
  443.         Version 3.2 DOES NOT NEED DBASE TO RUN.
  444.  
  445.         To see what this program can do, extract the documentation file in
  446.         LOGDOC and read it.
  447.  
  448.         CONTEST
  449.  
  450.         Keeps Dupes in memory, logs QSO's to disk in format which can  be 
  451.         processed by the LOGBOOK package.  
  452.  
  453.         CQSS
  454.  
  455.         Sweepstakes  game.   Work the ARRL Sweepstakes  contest  on  your 
  456.         computer.   You  are  located  just  outside  Washington  DC.   A 
  457.         propagation  model is built in to the program.  This  program  is 
  458.         REQUIRED  training  for all sweepstakes  operators.   Program  is
  459.         based on the one described in detail in 'Software for Amateur 
  460.         Radio' by Joe Kasser G3ZCZ, published by TAB Books, Blue Ridge  
  461.         Summit, PA. 17214.
  462.  
  463.         WHATSON
  464.  
  465.         Predict HF Propagation. Contest mode with printout to whole world 
  466.         at hourly intervals. Needs BASIC
  467.  
  468.  
  469.         This  software  AND MORE comprises PC-HAM which is  available  as 
  470.         Shareware  from G3ZCZ.  Send a disk, SASE, and a QSL card  for  a
  471.         copy.   Users  are asked to register for $36.50  (half  of  $73).  
  472.         Request PC-HAM.
  473.  
  474.         For an evaluation copy (unregistered full blown version) of each 
  475.         software send a formatted disk and SASE to Joe Kasser.  Overseas
  476.         users,  send  $3.00  instead. Try  the  software first, and only 
  477.         register your copy if you make use of it.  If you like LAN-LINK, 
  478.         you will like PC-HAM.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  489.         WHATS-UP.DOC Page 9.
  490.  
  491.  
  492.         LAN-LINK 1.55  Registration Fee $35.00 
  493.         PC-HAM   3.3   Registration Fee $36.50
  494.         WHATS-UP 0.3   Registration Fee $35.00
  495.  
  496.         Evaluation Copies free, you pay only for the disk/postage.
  497.  
  498.                 To: Joe Kasser G3ZCZ
  499.                      P O BOX 3419
  500.                      SILVER SPRING
  501.                      MD 20918.
  502.  
  503.                 CALL ________________   TODAY'S DATE _____________
  504.  
  505.                 NAME ______________________________________________
  506.  
  507.                 ADDRESS ___________________________________________
  508.  
  509.                         ___________________________________________
  510.  
  511.                 CITY    ___________________________________________
  512.  
  513.                 STATE   _________  POSTCODE  ______________________
  514.  
  515.                 TNC TYPE _____________________ Home BBS __________
  516.  
  517.         I enclose a check for ______.  Please send me the latest  version 
  518.         of ______________,  and register me as  a user.
  519.  
  520.         I enclose a disk/sase or $3.00. Please send me the latest version of
  521.         ______________________ to evaluate.  If I like it and use it, I plan 
  522.         to become a registered user.
  523.  
  524.         Disk Size 5.25 ______ 3.5 ______
  525.  
  526.         I AM NOT/AM currently using Shareware Version _____
  527.  
  528.         which I obtained from  _________________________________________.
  529.  
  530.  
  531.                 Signature
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.         COPYRIGHT Joe Kasser, G3ZCZ 1990.
  550.